home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 061-070 / amok63 / m2ced / m2ced.dok < prev    next >
Text File  |  1993-11-04  |  10KB  |  248 lines
  1. ----------------------------------------------------------------------
  2. Dokumentation zu "M2CED" Version 1.4(alpha)
  3. Autor: Steffen Reith, Hessenstr. 64, D-8700 Würzburg
  4. ----------------------------------------------------------------------
  5.  
  6.                            Copyrightvermerk
  7.  
  8. Der  Autor  dieses Programms ist nicht verantwortlich für irgendwelche
  9. Schäden, die durch die Benutzung dieses Programms entstehen können.
  10.  
  11. M2CED  ist  ein  SHAREWARE-Programm.   Bitte senden Sie DM 15,- an den
  12. Autor, wenn Sie das Programm verwenden sollten.
  13.  
  14. Das  Programm  darf  nicht  zur  Schulung  bzw.   Ausbildung von mili-
  15. tärischen  Personals  verwendet  werden.  Das Programm darf nicht nach
  16. Südafrika exportiert werden.
  17.  
  18. M2CED ist  ©  1990/1991  by  Steffen Reith.  Das kommerzielle Kopieren
  19. dieses  Programms  steht gemäß §108a Urheberrechtsgesetz unter Strafe.
  20. Abweichend von der sonst üblichen Regelung verzichtet der Autor jedoch
  21. auf  einen Teil der ihm gemäß §106 UrhG zustehenden Rechte und erlaubt
  22. folgendem Personenkreis das Kopieren und Weitergeben des Programms:
  23.  
  24.                Amok,
  25.                Fred Fish, im Rahmen der AmigaLibDisks
  26.                sowie allen Personen, die das Programm nichtkom-
  27.                merziell weitergeben wollen.
  28.  
  29. Die  nichtkommerzielle  Weitergabe  des  Programms wird vom Autor aus-
  30. drücklich unterstützt.
  31.  
  32.                                Achtung
  33.  
  34. Dieses  Programm  darf  nur  mit  dieser  Dokumentation  weitergegeben
  35. werden.
  36.  
  37. Kommerzielle  Weitergabe  liegt  nach  Auffassung des Autors vor, wenn
  38. neben  den  Versandkosten  und den Kosten für den Datenträger mehr als
  39. eine  Unkostenerstattung  von  DM  1,-  pro Kopie verlangt wird.  Alle
  40. Personen,  die  dieses  Programm entsprechend obenstehender Definition
  41. kommerziell  weitergeben  wollen,  bedürfen dazu der schriftlichen Ge-
  42. nehmigung  des  Autors.   Diese  kann mit Angabe von Gründen und einem
  43. frankierten Rückumschlag beim Autor beantragt werden.
  44.  
  45. Zuwiderhandlungen  gegen diese Weitergabebestimmungen werden mit allen
  46. Mitteln verfolgt, die das Urheberrechtsgesetz zur Verfügung stellt.
  47.  
  48. Die SHAREWARE-Gebühr, Anmerkungen, Verbesserungsvorschläge sowie nach-
  49. vollziehbare   Beschreibungen   auftretender   Fehler  sind  jederzeit
  50. willkommen und sollten an folgende Adresse gesandt werden:
  51.  
  52. Steffen Reith
  53. Hessenstr. 64
  54. D-8700 Würzburg
  55.  
  56. Soll  ich  Rückantworten geben so legen Sie bitte einen frankierten an
  57. Sie adressierten Umschlag bei.
  58.  
  59. "M2CED" ist keine Public Domain Software.
  60. © 1990 Steffen Reith
  61. Alle Rechte vorbehalten
  62.  
  63.                               Einleitung
  64.  
  65. Es  hat  mich  schon  die ganze Zeit gestört, daß man bei der Modula-2
  66. Programmierung  ganz  auf m2emacs angewiesen war.  Deshalb entwickelte
  67. ich  M2CED  um  Compiler,  Linker sowie einen Fehlerlister vom CED aus
  68. aufrufen zu können ohne Besitzer von ARexx sein zu müssen.
  69.  
  70. Umfang des Packets
  71.  
  72. Zum vollständigen Umfang des Pakets "M2CED" gehören:
  73. (Stand 16.6.1991)
  74. M2CED.dok               ( dieser Text )
  75. CED.def                 ( Quelltext im Verzeichnis "txt" )
  76. CED.mod                     "
  77. Msg.def                     "
  78. Msg.mod                     "
  79. Config.def                  "
  80. Config.mod                  "
  81. ErrorMsg.def                "
  82. ErrorMsg.mod                "
  83. Errors.def                  "
  84. Errors.mod                  "
  85. Keys.def                    "
  86. Keys.mod                    "
  87. Files.def                   "
  88. Files.mod                   "
  89. SM (Start Modula ) ( unten beschriebenes Minibatchfile )
  90. ConfigEd.mod       ( Quelltext im Verzeichnis "txt" )
  91. ConfigEd           ( extrem primitives Programm zur
  92.                      Erstellung der Datei S:M2CED.config )
  93. M2CED.config       ( sollte in das s: Verzeichnis kopiert werden)
  94.  
  95.                                Änderung
  96.  
  97. Sollten Sie eine geniale Verbesserung an meinem Programm vornehmen, so
  98. schicken Sie mir bitte eine Kopie davon.
  99.  
  100.                               Bedienung
  101.  
  102. M2CED  mit  run M2CED und eventuellen Optionen aufrufen.  Dabei sollte
  103. sich  der  CED  im  Speicher  befinden  (Im Hintergrund oder schon mit
  104. offenen Screen)
  105.  
  106. > Beispiel: run M2CED n a
  107.  
  108. Zu beachten
  109.  
  110. -Im LIBS: Verzeichnis müssen sich die Files arp.library und
  111.  req.library befinden
  112. -Der run-Befehl muß im C: Verzeichnis enthalten sein
  113. -Es wird CygnusEd Professional mit req.library benötigt
  114. -m2c und m2l müssen im Pfad, der mit ConfigEd festgelegt wurde, zu
  115. finden sein
  116. -Die Datei Fehler-Meldungen muß sich im Verzeichnis M2: befinden
  117.  
  118.  
  119.                              Der ConfigEd
  120.  
  121. Für  diese  Version wurde das Programm ConfigEd implementiert, mit dem
  122. die  M2CED  Umgebung  konfiguriert  werden kann.  Die Tasten müssen in
  123. diesem  Programm  durch  ihre RAW-Key-Codes spezifiziert werden.  (Wer
  124. denkt sich da mal was besseres aus?  Ich habe im Moment keine Zeit!! )
  125.  
  126.  
  127.                                Optionen
  128.  
  129. Erlaubte Optionen sind a, n, r und neu v.
  130.  
  131. Option A
  132. Beim  Start  eines  compilierten  und gelinkten Files wird ein kleiner
  133. Requester  geöffnet  und  nach der Argumentenliste für dieses Programm
  134. gefragt.
  135.  
  136. Option N
  137. Der  Compiler  m2c  und Linker m2l wird nicht mit dem Pfadnamen des zu
  138. bearbeiteten  Programms  aufgerufen.  Gleichzeitig wird das CurrentDir
  139. der M2CED-Prozesses so geändert, daß der m2c und m2l seine Erzeugnisse
  140. im  Verzeichnis, das im Feld Drawer des CED angegeben wurde, abgelegt.
  141. Wird  diese  Option  nicht  eingeschaltet, so wird m2c und m2l mit dem
  142. vollen  Pfadnamen  aufgerufen.  Gleichzeitig wird das CurrentDir nicht
  143. geändert.   Dies hat zur Folge, daß alle Ergebnisse in dem Verzeichnis
  144. abgelegt werden, in dem M2CED aufgerufen wurde.
  145.  
  146. Option R
  147. Ist  diese  Option  gesetzt, so wird M2CED beim Neustart des Programms
  148. nicht  das  letzte  compilierte  Programm laden und den Cursor auf die
  149. letzte Stelle im File positionieren.  Die entsprechenden Informationen
  150. befinden sich im File s:M2CED.restart.
  151.  
  152. Option V
  153. Ist  diese  Option  gesetzt, so werden Compilerläufe und Uhrzeit nicht
  154. aktualisiert.
  155.  
  156.                               Bedienung
  157.  
  158. Zur  einfacheren  Bedienung  sollte  man  sich eine Batchdatei mit dem
  159. folgenden Anweisungen anlegen:
  160.  
  161. CED
  162. RUN M2CED N A
  163.  
  164. Wird diese Datei gestartet, so erscheint nach einiger Zeit der CED und
  165. dann  die Meldung "M2CED V1.4(alpha) © by Steffen Reith is active" auf
  166. dem  Titlebar  des  CED.   Nun  kann  mit  der Arbeit begonnen werden.
  167. Sollte  noch keine Restart-Datei im s:  Ordner existieren oder ist die
  168. entsprechende  Option abgeschaltet, so erscheint der Filerequester des
  169. CED.   Ist  am  File S:M2CED.Config nichts verändert worden oder exis-
  170. tiert es nicht, so gelten folgende Tastenkombinationen:
  171.  
  172. ALT-c      Start des Compilers
  173. ALT-l      Start des Linkers
  174. ALT-o      Start des Optimizers wenn vorhanden (endlich gestorben)
  175. ALT-s      Start des ausführbaren Programms
  176. ALT-e      Laden einer Fehlerliste
  177. ALT-i      Anzeigen der nächsten Fehlermeldung und Positionierung des
  178.            Cursors
  179. ALT-Return Continue Funktion
  180. ALT-Esc    Verlassen des Programms
  181.  
  182. Diese  Voreinstellungen  können  mit  dem  Primitiv-Programm  ConfigEd
  183. jederzeit  den eigenen Bedürfnissen angepaßt werden.  Dabei müssen nur
  184. die entsprechenden Rawkey-Codes in die Requester eingetragen werden.
  185.  
  186.                                ACHTUNG:
  187.  
  188. Der  Compiler/Linker  kann nur dann einwandfrei gestartet werden, wenn
  189. der  Pfad  im  Feld  Drawer  des  CED-Load-Requesters  einen  gültigen
  190. AmigaDos-Pfad  darstellt,  d.h.   wenn  man  mit  CD  Pfad in das ent-
  191. sprechende Directory wechseln könnte.
  192.  
  193. Fehler
  194.  
  195. - Bisher konnte ich bei der Arbeit mit M2CED keine Fehler finden.
  196.  
  197. - Der einzige  Nachteil dieses  Programms  ist der im Moment  noch sehr
  198.   große Speicherbedarf von ca. 70 KB.
  199.  
  200. - Im Moment bin ich dabei die langen Ladezeiten der M2:Fehler-Meldungen
  201.   Datei zu optimieren sowie den Speicherhunger des Programms zu senken.
  202.  
  203. - Ist  die  Option  N abgeschaltet,  so kann es Probleme beim Start des
  204.   ausführbaren Programms geben
  205.  
  206. Neue Version
  207.  
  208. Bei  der  neuen  Version  (  V1.31  )  habe ich die Geschwindigkeit des
  209. Ladevorgangs  der  M2:Fehler-Meldungen Datei wesentlich optimiert.  Neu
  210. habe  ich auch die Positionierung des Cursor beim Neustart hinzugefügt.
  211. Für  die  Zukunft  sind  Unterstützung  verschiedener  Compiler,  ein
  212. Modula2-Precompiler  ähnlich  den in C gebräuchlichen, eine Möglichkeit
  213. unvollständige  Symbole  auszuschreiben  sowie  kontextabhängige Hilfe-
  214. meldungen geplant.
  215.  
  216. Die  neue  Version  (1.4a) wurde mit dem neuen M2AmigaV4.0 kompiliert.
  217. Dadurch hat sich die Programmlänge drastisch verkürzt (auf ca.  20KB).
  218. Neu   wurde   auch   die   Möglichkeit  implementiert  die  Zahl  der
  219. Compilerläufe  mitzuzählen.  Dazu existieren zwei neue Einträge in den
  220. AMOK-Standardheadern:
  221.  
  222.     :System.     $$Date: 17-06-1991  13:14:59
  223.     :System.     $$CompilerRuns #13#
  224.  
  225. M2CED  sucht  nach  den  Strings  $$Date:  und trägt hier die aktuelle
  226. Uhrzeit/Datum  ein.  Für die Datumsabfrage wird der Einfachkeit halber
  227. das  Modul  TimerSupport  von  Hartmut  Höhn  verwendet.  Die Variable
  228. $$CompilerRuns  gibt  an wie oft dieses File schon mit M2CED übersetzt
  229. wurde.   Die  kontextabhängigen Hilfemeldungen sind mit Erscheinen von
  230. M2Ohm  gestorben (besser geht es wohl kaum noch).  Der Precompiler ist
  231. durch  die  bedingte  Kompilierung  von  M2AmigaV4.0  auch überflüssig
  232. geworden.
  233. Auch  die Option zum Starten des Optimizers wurde aus Faulheitsgründen
  234. noch nicht entfernt.
  235. In  der  Zukunft ist eine total neue Version dieses Programms geplant.
  236. Sie  wird ausschließlich mit Kickstart V2.0 zusammenarbeiten und nicht
  237. nur  den  CygnusEd unterstützen.  Weiterhin wird die totale Einbettung
  238. in  die  M2Amiga-Umgebung (z.B.  leichtes Setzen der Compiler-Switches
  239. etc.) angestrebt
  240.  
  241.  
  242.                                               Viel Spaß
  243.  
  244.                                                    Steffen Reith
  245.  
  246.  
  247.  
  248.